Get Mentions

This tutorial shows you how to retrieve mentions/posts that match the keywords you are monitoring after a project has been created.

Prerequisites

• ✅ A project already created (see Create Projects Tutorial)
• ✅ A valid authentication token
• ✅ The project ID for the project you want to query

Step 1: Retrieve all mentions

Fetch all mentions for a given project.
Copy the project ID you created earlier and use it in your request.

See the full API reference:
Full API docs: Mentions API

Sample response

{
  "data": [
    {
      "id": "6732e9c9c04e0a5e8a7f8c1b",
      "content": "Produk dari Project Alpha sangat membantu workflow saya!",
      "createdat": "2024-11-09T10:15:00Z",
      "keywordid": "6732e9c9c04e0a5e8a7f8c1c",
      "sentimen": 1,
      "socialmediaid": "twitter",
      "targeted_account_id": "6732e9c9c04e0a5e8a7f8c1d",
      "updated_at": "2024-11-09T10:15:00Z",
      "SnaKeyword": {
        "group": "Project Alpha",
        "keyword": "produk"
      },
      "targeted_account": {
        "display_name": "Tech Enthusiast",
        "username": "@techenthusiast"
      }
    }
  ],
  "limit": 10,
  "page": 1,
  "total": 42,
  "totalPages": 5
}

---

Understanding the response data

Mention object

• id: Unique identifier for the mention
• content: The text/content of the mention/post
• createdat: Time the mention was created (ISO 8601 format)
• keywordid: ID of the keyword that matched this mention
• sentimen: Sentiment score (0: neutral, 1: positive, 2: negative)
• socialmediaid: Identifier of the social media platform
• targeted_account_id: ID of the account that posted the mention
• updated_at: Last update time for this record
• SnaKeyword: Keyword and project info
  • group: Project name (parent group of the keyword)
  • keyword: Keyword used for monitoring
• targeted_account: Account information
  • display_name: Full display name of the account
  • username: Handle/username of the account

---

Next steps

After you retrieve mentions, you can:

1. Generate a summary → Use the AI Service to create an overview
2. Export data → Export mentions for reporting (from the web UI)

📖 Full Mentions API documentation
📖 Project Summary Tutorial

---

Troubleshooting

Common issues

Empty response

• Make sure scraping has been started for the project
• Check whether the keyword is relevant enough to return data
• Verify that the date range used is not too narrow

401 Unauthorized

• Confirm that your token is still valid
• Refresh the token if it has expired

429 Too Many Requests

• Add a delay between requests
• Use batch processing when calling multiple requests